home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / gopher / Unix / gopher-gateways / techinfo / gophtech / v1.6 / INSTALL.Z / INSTALL
Encoding:
Text File  |  1993-07-08  |  3.2 KB  |  98 lines
  1.  
  2.  
  3. ********** How to install the gopher-techinfo gateway **********
  4.  
  5. 1) Edit the file "gw.h" and change any #defines that need to
  6.    be changed.
  7.  
  8.    DEBUGLOG        the filename where the gateway will write
  9.             debugging and statistics information.  The
  10.             gateway runs as userid "daemon", so make sure
  11.             daemon has write permission on this file.  If
  12.             necessary, create an empty file and change
  13.             owner to daemon.
  14.  
  15.    MSGFILE        the filename of the "About this Gopher" item.
  16.             The gateway will read this file and send it to
  17.             the Gopher client.  See the file "MSG" for an
  18.             example.  DAEMON needs read permission for
  19.             this file.
  20.  
  21.    LOCALTI_SERVER    the domain name of the local Techinfo server
  22.             The gateway connects to this server when a
  23.             gopher sends "" as the token.  At UPENN, the
  24.             name is penninfo-srv.upenn.edu.
  25.  
  26.             if there's no local TechInfo, change this line to:
  27. #define LOCALTI_SERVER ""  /* there is no local techinfo */
  28.  
  29.    LOCALTI_PORT        the port that the local TechInfo server
  30.             listens at (ignored if LOCALTI_SERVER is "").
  31.  
  32.    LOCALTI_MAINMENU    the nodeid of the top menu of the local
  33.             Techinfo server (ignored if LOCALTI_SERVER is
  34.             "").  You can pick any menu's nodeid.
  35.  
  36.  
  37.    TISERVERS_HOST    the domain name of the host that knows the
  38.             list of TechInfo servers.
  39.  
  40.    TISERVERS_PORT    the port at which the TISERVERS_HOST server
  41.             listens.
  42.  
  43.    LOCALGOPHTITLE    the name(title) of a gopher server.  If
  44.             you don't want to point to any, set it to
  45.             "".  If you leave it blank, then
  46.             LOCALGOPHERSERVER, LOCALGOPHERPORT, and
  47.             LOCALGOPHERPATH are ignored.  Otherwise,
  48.             the gateway sends them along with the
  49.             title as part of the root menu.  The
  50.             local gopher file type must be a Gopher
  51.             Directory file (gopher type 1).  For the
  52.             local gopher server at UPENN, these three
  53.             values should be "gopher.upenn.edu", port
  54.             "70", and "".
  55.  
  56.    SOURCES_MSGFILE    Name of file that describes how to view the
  57.             Gopher path & use it to see the TechInfo Source.
  58.  
  59.    SOURCES_NODEID    Nodeid of the TechInfo document at LOCALTI_SERVER.
  60.             Ignored if there is no LOCALTI_SERVER.
  61.  
  62.  
  63.  
  64. 2) Compile the gateway code:
  65.     make -k
  66.  
  67. 3) Move the executable to /usr/local/bin or whatever is the convention
  68.    on your operating system.
  69.  
  70. 4) Edit /etc/services and add the gopher service to it, if it's not
  71.    already there:
  72. gophtech    71/tcp
  73.  
  74. 5) Edit /etc/inetd.conf and add the gophtech gateway to it.  The
  75.    gateway program takes two arguments: the domain name of the
  76.    localhost, and the port at which the gateway is listening.
  77.  
  78. Example:
  79.  
  80. gophtech stream tcp nowait /usr/local/bin/gophtech gophtech gopher-penninfo.upenn.edu gophtech
  81.  
  82. 6) Send a HUP to the inetd daemon so that it will re-read inetd.conf.
  83.  
  84. 7) Copy MSG and PROVIDERS to the right directory.
  85.  
  86.    Give DAEMON the permission to read these files, since the gateway
  87.    runs as userid DAEMON.  chmod ugo+r .../{MSG,PROVIDERS}
  88.  
  89. 8) Define the domain name (or a CNAME) in the domain name system for
  90.    your site.  In the example I used above, it would be
  91.    gopher-penninfo.upenn.edu.
  92.  
  93. 9) The MSG file refers to a mail alias to report bugs with
  94.    the gophtech gateway (gopher-penninfo@dccs.upenn.edu).  Please
  95.    create the mail alias and be sure that at least murphy@dccs.upenn.edu
  96.    is on the list.  I don't know who, if anyone else, should be on
  97.    it.
  98.